aboutdialog: tweak the docs

Add a short summary.

label: Convert docs

Change link syntax, add singl-line summaries,
add missing property docs.

docs: Bring the widget gallery back

We have all the images, lets put them to use.

docs: Remove the last few remaining '+' from GTK

docs: Clean up the first paragraph for various symbols

The documentation engine will use the first paragraph as the summary for
a type or constant.

docs: Show summary in the namespace index

docs: Start porting GtkImage to the new style

docs: Port GtkAboutDialog to the new syntax

We should also clean up the annotations, while we're at it.

build: Quiet down gi-docgen

We are only interested in the warnings and errors.

docs: Fix up the style of the X11 content file

docs: Move detached sections into their own content file

docs: Split GdkDrag and GdkDrop sections

This way we have a section for each class.

docs: Rename GdkTexture section

The name needs to match the class.

docs: Move gdkcairo section to an external file

docs: Move the gtkmain section to its own document

The introspection data does not handle unattached sections like gtk-doc
does, so we need to move what was gtkmain into its own Markdown
document.

docs: Use new link syntax

docs: Begin porting GtkWidget to the new format

doc: Port GtkConstraint to the new format

docs: De-indent GtkRecentInfo.get_applications() return value

Otherwise the four spaces will be treated as a pre-formatted block by
Markdown.

docs: Start porting GtkConstraintLayout to the new doc format

Drop the old gtk-doc'isms, and use the gi-docgen links instead.

docs: Add metadata preamble to GTK's content files

docs: Drop gtk-doc files

We don't use gtk-doc to generate our API reference, so we don't need its
files lying around any more.

Generate GTK API reference(s) with gi-docgen

Stop using gtk-doc, and switch to gi-docgen.

The gi-docgen tool generates API references through the introspection
data, which has various benefits:

 - it does not parse C code
 - it does not generate and run C code to introspect types at build time
 - it does not present a different API from the one we're exporting

Additionally, gi-docgen:

 - does not generate DocBook XML in order to generate HTML
 - does not go through xsltproc
 - parses proper Markdown

Which makes it markedly faster than gtk-doc has ever been.

Add gi-docgen as a subproject

While we're developing gi-docgen it's better to have it as part of our
build.

ci: Update the fedora-docs Docker image

Use the latest base image.

ci: Update the CI image for docs building

We don't use Pandoc any more, but we need a bunch of Python modules for
gi-docgen.

ci: Update the reference job

Rename base version argument in run-docker.sh

The `--base-version` argument trips up everyone. Might as well rename it
to `--version`.

Merge branch 'fix-menubutton-tooltips' into 'master'

Limit tooltip queries to the same native

Closes #3719

See merge request GNOME/gtk!3283

Limit tooltip queries to the same native

Without this, the menubuttons tooltip pops up
when hovering the popover, which is suprising
and unintended.

Fixes: #3719

Merge branch 'gdk-win32-use-window-from-point-for-master' into 'master'

GdkWin32: Fix mouse events in presence of transparent windows on the desktop

Closes #370, #417, and gimp#1082

See merge request GNOME/gtk!2800

Merge branch 'matthiasc/for-master' into 'master'

inspector: Fix surface transform regression

See merge request GNOME/gtk!3280

inspector: Fix surface transform regression

Ever since we added surface-to-widget transforms,
the autofading of the fps overlay did not work anymore,
since it was given the transient transform node, most
of the time.

Fix this by passing both the root of the node tree and
the node for the toplevel widget to prepare_render, and
hande the widget node to the overlays. Update the
affected overlays that need to have their positioning
adjusted.

Update Serbian translation

(cherry picked from commit f33a2febc7df6ec9c7721361f94121c2db079057)

Merge branch 'wip/otte/for-master' into 'master'

Wip/otte/for master

See merge request GNOME/gtk!3279

wayland: Fix memleaks when rendering with Cairo

We were leaking buffers. This wasn't caught by valgrind and friends
because it was shared memory (with the compositor), but top(1) would
instantly see memory consumption of the app and the shell go through the
roof.

wayland: Don't call _gdk_surface_update_size() all the time

We were calling _gdk_surface_update_size() every frame, even if the
window size didn't change. This would cause us to discard all cached
buffers and redraw the whole screen.

This was BAD.

Merge branch 'ngl-rect-borders' into 'master'

Speed up border rendering

See merge request GNOME/gtk!3278

nodeparser: Print debug message before child

This puts the message up top, where it can be seen,
and not at the other end of an endless tree of children.

Update tests to match.

ngl: Render simple borders simply

Use 4 color commands for uniform, rectilinear
borders. Most of our borders are rounded with
Adwaita, but there are still some of these.

gsk: Add gsk_border_node_get_uniform_color

Maintain this bit of information separately,
it will be useful in the next commit.

vulkan: Improve rounded rect clipping

Handle the case where the inner rounded rect is fully contained
within the outer rounded rect.

vulkan: Fix invalid read

Look at the right rect to compute circularness

Merge branch 'meson-override-dep' into 'master'

meson: override gtk4 dependency

See merge request GNOME/gtk!3277

meson: override gtk4 dependency

This allows applications that depends on gtk4 to build it as subproject
without hardcoding 'gtk_dep' variable name in their build definition.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!3276

Merge branch 'bilelmoussaoui/size-request-annotations' into 'master'

g-i: update distribute_natural_allocation annotation

See merge request GNOME/gtk!3271

node-format: Small docs fixes

spinbutton: Interpret localized digits

Interpret input where the characters have numeric values.

See #3387

Merge branch 'ngl-clip-classification' into 'master'

Ngl clip classification

See merge request GNOME/gtk!3274

glsl: Make rounded rect clipping cheaper

Add early acceptance checks for non-corner cases.

Merge branch 'matthiasc/for-master' into 'master'

Revert "ngl: Remove a few redundant checks"

See merge request GNOME/gtk!3273

Revert "ngl: Remove a few redundant checks"

This reverts commit 4375f8e382ef035d970dd255f56d1a7470c1a78c.

These were not redundant after all, as pointed out by Timm.

Add some more rounded rect tests

gsk: Use clip defines in shaders

Use the NO_CLIP and RECT_CLIP defines to make
simpler shaders for these cases.

Note: This does not work yet.

ngl: Add infrastructure for clip-variants of shaders

Make ngl compile each shader three times.
Once with #define NO_CLIP 1
once with #define RECT_CLIP 1
and once as before.

ngl: Classify clips

Maintain the 'fully contained' information in the clip
stack. This will let us pick simpler shaders in the future.

Merge branch 'ebassi/iface-macros' into 'master'

Remove invalid class macros

See merge request GNOME/gtk!3270

Move gtk_rounded_rect_scale_affine to the right place

This function should live with the rest of the
GskRoundedRect code in gskroundedrect.c.

imcontext: Fix a docs mishap

g-i: update distribute_natural_allocation annotation

Merge branch 'bilelmoussaoui/gi-annotations' into 'master'

g-i: add missing since annotations for 4.2

See merge request GNOME/gtk!3268

g-i: add missing since annotations for 4.2

Merge branch 'scalable-svg' into 'master'

icons: Rename two icons which had the wrong extension

See merge request GNOME/gtk!3269

docs: Remove invalid macros

treesortable: Remove class check macro

orientable: Remove class macros

celleditable: Remove class cast check macro

buildable: Remove "class" macro

icons: Rename two icons which had the wrong extension

Fixes two warnings when opening the inspector on my PinePhone, these two
files were attempted to be loaded as PNG (as per the extension) instead
of SVG.

Signed-off-by: Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>

Merge branch 'ngl-misc-fixes' into 'master'

Ngl misc fixes

See merge request GNOME/gtk!3267

Update Latvian translation

(cherry picked from commit 1d62020a1912c410a24879922c34284f8a534e54)

ngl: Treat radial gradients like others

Handle colorstop overflow for radial gradients
the same way we do for linear and conic gradients.

ngl: Remove a few redundant checks

We bail early on invisible nodes. No need to
repeat that check in individual visit functions.

Merge branch 'matthiasc/for-master' into 'master'

Revert "flatpak: No need to build sassc anymore"

See merge request GNOME/gtk!3266

roundedrect: Remove unclear language from the docs

The various intersection function for rounded rects are
precise. No need to add wordy disclaimers about the handling
of the corners.

Revert "flatpak: No need to build sassc anymore"

This reverts commit 9a540841fd5c18394456a3dfcfde721a69ed4724.

Merge branch 'matthiasc/for-master' into 'master'

vulkan: Add visible fallback rendering

See merge request GNOME/gtk!3264

Update French translation

(cherry picked from commit 5b18df9b5ebe2a8786c53a62b63ba84c1a1fd3a3)

Update Serbian translation

(cherry picked from commit b9a451423fe54e8f93fd39d8ef01f4fb835b4655)

Update Korean translation

(cherry picked from commit 60a714a25ff40a36f969b154d04036c56dbf067f)

Update Catalan translation

vulkan: Handle simple transforms in the clipping code

Requires pushing the GskTransform into the clipping code so that we
can actually look at its category.

vulkan: Add visible fallback rendering

Hook up the "Show fallback rendering" switch for Vulkan.

This brings home the sobering truth that the Vulkan renderer
is doing *all* fallback, since we switched from offset nodes
to transform nodes.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!3263

searchentry: Typo fix

flatpak: Fix the gtk4-demo build

This was overlooked in 8e7e821033abb291391c26aa288a8.

Merge branch 'wip/exalm/window-shadow-dark-4' into 'master'

Adwaita: Use transparent black for window border in dark too

See merge request GNOME/gtk!3261

Merge branch 'wip/jimmac/fix-flatpak-build' into 'master'

Flatpak: Update build manifests

See merge request GNOME/gtk!3259

Adwaita: Use transparent black for window border in dark too

Avoid smear when the background behind the window is dark. Adjust opacity
to make it appear roughly the same as before on white background.

Merge branch 'wip/jimmac/sidebar-focus' into 'master'

Adwaita: Regular focus ring for sidebar rows

Closes #3708

See merge request GNOME/gtk!3258

Flatpak: Update build manifests

- point to the upstream repo for wayland
- disable disabling of sassc
- switch wayland from autotools to meson

Adwaita: Regular focus ring for sidebar rows

- style sidebar rows as regular items like buttons wrt focus
- define transition as part of the focus-ring(),
  only animate outline related properties rather than `all`

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3708

Update Indonesian translation

(cherry picked from commit e54dc87a152aa7379aa015e9fc5ea3aaa793c231)

Merge branch 'iconbrowser-fix' into 'master'

iconbrowser: fix search<>category interaction

Closes #3717

See merge request GNOME/gtk!3257

iconbrowser: fix search<>category interaction

Make search act like a separate, filtered view of
all icons. This is how it worked in gtk3, and how
it should be.

Fixes: #3717

Merge branch 'preedit-selection-fix' into 'master'

Preedit selection fix

Closes #1123

See merge request GNOME/gtk!3255

textview: Delete selection when preedit starts

This prevents confusing misrendering when the preedit text
pushes the selection text out of the rendered selection.

Fixes: #1123

textview: Send anchor with surrounding

We have the api to do it now.

text: Optimize away 0-change insertions and deletions

We can short-circuit insert and delete calls that are
not causing any change.